Microsoft Commerce Server 2000 Software Development Kit Readme

Welcome to the Microsoft Commerce Server 2000 Software Development Kit (SDK). The SDK includes tools, headers, libraries, and sample code to jumpstart your development efforts for Microsoft® Commerce Server 2000. This readme contains a summary of the SDK contents, as well as the latest information about the SDK. For more information about the SDK, see the SDK Road Map in the "Developing Your Site" topic in Commerce Server 2000 Help.

The SDK can be found on the product CD in \Program Files\Microsoft Commerce Server\SDK. After you install Commerce Server, you can navigate to this folder from the Start menu. Click Start, point to Programs, point to Microsoft Commerce Server 2000, and then click Software Development Kit.

This document provides information about the following:

Setting Up the Commerce Server SDK

Platform SDK

Many elements of the Commerce Server 2000 SDK are dependent on components of the Microsoft® Platform SDK. You must install the latest version of the Platform SDK before you can build many of the samples and tools included in the Commerce Server 2000 SDK.

For more information about the Microsoft Platform SDK, see:

Include Files

You must also update the include path for your computer and your Microsoft® Visual C++® directory options to contain the path to the Commerce Server SDK Include folder.

Header Files

The header files and Interface Description Language (IDL) files required to use and extend the services provided by Commerce Server 2000 in Microsoft Visual C++ are found in the Include folder of the SDK. For example, C:\Program Files\Microsoft Commerce Server\SDK\Include.

For more information about the header and IDL files required to use a specific Commerce Server object from a Microsoft Visual C++ project, see the help topic for the specific object in the "Object Reference/C++ Invocation" section of the Programmer's Reference in Commerce Server 2000 Help.

Code Samples

This section lists the code samples and scripts included in the Samples folder of the Microsoft Commerce Server 2000 SDK. The code samples are supplied as complete Microsoft® Visual Studio® projects. To use a sample, open the project file and build it in Visual Studio. Sample code is provided for the following areas. The name of the sub-folder containing the sample code is shown in parentheses.

Sitelets

In addition to the traditional code samples provided in the Commerce Server 2000 SDK, small-scale Commerce Server 2000 sites (referred to as Sitelets) are also included. The Sitelets demonstrate how to use the API for a particular feature from Active Server Pages (ASP), without integrating that feature with the rest of the run-time services for Commerce Server 2000. This helps you isolate and understand a particular feature without having to filter out code unrelated to the task you wish to perform. The following Sitelets are included with the SDK:

The Sitelets can be found in the Sitelets directory of the SDK Samples directory. For example, C:\Program Files\Microsoft Commerce Server\SDK\Samples\Sitelets. You install Sitelets in the same way you install Solution Sites: by unpacking a Commerce Server Site Package.

Tools

The Commerce Server 2000 SDK includes a set of tools to help you simplify and speed up the development process for building the following:

The following tools have been provided in the SDK. The name of the sub-folder containing the tool is shown in parentheses.

Known Issues

The following are the known issues for the Microsoft® Commerce Server 2000 SDK:

Errors compiling the Site Status Snap-in

When you are compiling the Site Status MMC Snap-in code sample, you may encounter one or more of the following errors:

D:\Program Files\Microsoft Platform SDK\include\mmc.h(417) :
 error C2146: syntax error : missing ';' before identifier 'HSCOPEITEM'

-OR-

D:\cs40 source code\SDK\plutonium\Samples\Site Status\Comp.h(31) :
 error C2504: 'IExtendPropertySheet2' : base class undefined

To resolve either of these issues, verify that you have installed the required elements of the Platform SDK and that the system include path and Visual C++ Include directory have been updated to include the path to the Commerce Server 2000 SDK Include directory.

_________________________________________________________________

Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, people and events depicted herein are fictitious and no association with any real company, organization, product, person or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation.

Microsoft. ActiveX, Visual Basic, Visual C++, Visual Studio, Windows, Windows NT, and Win32 are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Other product and company names mentioned herein may be the trademarks of their respective owners.

Copyright © 2000 Microsoft Corporation.  All rights reserved